Task Builder Definition

Definition > Task Builder Definition

Minimum Requirements

The Task Builder and Event Trigger buttons will only display if the SmartLink component has been installed on a workstation and registered with the EntraPass server.

Task Builder Dialogs Description

1 - From the Definition toolbar, select the Task Builder button.

The Task Builder menu allows you to create SmartLink tasks. When you have a SmartLink application installed, the Task insertion menu for SmartLink button is enabled. It allows operators to send built-in task commands to the SmartLink.

Note: A new command has been added to SmartLink (BATCHMODIFY) allowing batch modifications to a group of cards. It is now possible to change parameters for a group of cards of the same type. Only the data fields indicated in the command will be modified. For more information on task commands, refer to your SmartLink Reference Manual DN1327.

2 - Click on the Task insertion menu for SmartLink button and a menu will be displayed, or
use the buttons corresponding to the most common insertions.

Note: When creating SmartLink tasks, only commands that are written in the primary language are considered as valid commands. For more information on task commands, refer to your SmartLink Reference Manual, DN1327.

The following table describes the options you will find in the menu.

Parameter	Description
Date	Insert a date in the task. Options are: Year, Month, Day, YYYY/MM/DD or MM/DD/YYYY
Time	Insert a time in the task. Options are: Hour, Minute, Second, HH:MM:SS or HH:MM.
Event	Insert event description in the task. You can select to display event name Text or Number.
Location	Insert the location where the task must take place. Options are: EntraPass Application, Gateway or connection.
Information #1 to 4	Insert event information. Options in the database are: Index Number, Index Text, Component ID and Component Text.
User Information	Insert card information in the task. Options are: Card Number, Card User Name, Card Information #1 to #10 or Comment.
Numerical Value	Insert a number in the task.
Character String	Insert a string of characters (free text) in the task.
Add Delay	Insert a delay in 1/10 secs in the task.
Carriage Return	Insert a carriage return in the task.
Trim Right	Will delete the last character to the right of the task.
Email	To insert and email in the task that will be sent automatically when the event occurs.
Modem	To insert a message in the task that will be sent automatically through a pager when the event occurs.
Serial Device for Messages	Select the Serial Com Port and Baud rate to send the message.
Serial Device for Commands	Select the Serial Com Port and Baud rate to send the command.
File	File opens the Select a file name dialog that allows you to locate a file (or create a new one) where all event information entered in the task will be logged when an event occurs. Close will close the file. Commit to disk will save the file to disk. This command will not close the file.
Execute	File opens the Select a file name dialog that allows you to locate the executable that will be used with the task command. Parameters open the Enter Character Strings dialog allowing you to type a string of characters that will be added to the task command. Action allows you to define how you want to launch the task (Launch Hidden, Launch Normal, Launch Minimized, Launch Maximized or Terminate process).
Network	Insert a Network Tag.
Command	Insert a Command Tag.
Modify Language	You can modify the command language to English or French.
Save SmartLink Mode	Insert in the SmartLink command to interrupt and place current SmartLink mode in the background (for example sending and email). This command must always be used with Restore Previous SmartLink Mode.
Restore Previous SmartLink Mode	Insert in the SmartLink command to restore the previous SmartLink mode. This command must always be used with Save SmartLink Mode.

Adding an Email to a Task

1 - Once you have selected an existing task or created a new one, click the Mailbox button. The Email Task Builder dialog will display on screen.

2 - Enter the your email address in the From... field.

3 - Enter the email address(es) where the message should be sent in the To... field. Each address should be separated by a semi-colon (;).

4 - If you wish to send a copy of this email to other people, enter their name in the CC... field.

5 - Enter the Subject .

6 - If you want to attach a file to the email, enter the entire path to the file in the Attachment field. Each file must be separated by a semi-colon (;).

7 - Enter the message in the text area.

Note: Variables can be added to the email subject and body.

8 - Click OK to attach the email to the SmartLink task. The message will appear in the window.

Inserting a Pager Command in a Task

When building a task using SmartLink, EntraPass allows you to insert a command that will send a message to a paging system.

1 - Click the Modem button. The Modem task parameters dialog will display on screen.

2 - The Modem serial port parameter should already be setup.

3 - Enter Dial information such as the pager Phone number.

4 - Check the Pager options and enter the Message that will display on the pager (if the receiving pager has the option to display) and the Delay before message (seconds) will be sent to the pager. The time range value is 00:00 and 09:59 min.

5 - Click OK . The phone number and message will appear in the window

Inserting Serial Device for Messages

1 - Click the Serial device for messages button. The Serial com port dialog will display on screen.

2 - Select the Port Number and the Baud rate .

3 - Click OK .

Inserting Serial Device for Commands

1 - Click the Serial device for commands button. The Serial com port dialog will display on screen.

2 - Select the Port Number and the Baud rate .

3 - Click OK .

Inserting a File

1 - Click the File (Open) button. The Select a file name dialog will display on screen.

2 - Enter the file name or browse to find the file.

3 - Click OK .

Executing a File

1 - Click the Execute (File) button. The Select a file name dialog will display on screen.

2 - Enter the file name or browse to find the file.

3 - Click OK .

Executing Parameters

1 - Click the Execute (Parameters) button. The Enter character string dialog will display on screen.

Entering a Network Tag

1 - Click the Network button. The Enter network tag dialog will display on screen.

2 - Enter the network tag . The range value is 0 to 999,999.

3 - Click OK .

Entering Commands

1 - Click the Command button. The SmartLink Task Builder dialog will display on screen.

2 - Select a component type from the Component type list.

3 - Select a command from the Command list .

Note: The toggle command is only available with specific component types such as Door , Input and Relay .

4 - Select a variable from the Variables list . There are three categories of variable that can be linked to a component type and a command.

• Message Value

• Trigger

• Card Information 1 to 10

Task Building Examples

The following procedures will involve each of the three variables that can be linked to a component type and a command.

Building a Task with a Message Value Variable

1 - From the Definition toolbar, select the Task Builder button.

2 - Click on New and enter Decrement Card Usage Count as the task name.

3 - Click on the Command button.

4 - From the SmartLink Task Builder window, select Card from the Component type drop-down list.

5 - Select Decrement count usage from the Command list .

6 - Select Message Value from the Variable list . The task displays at the bottom of the dialog. Click OK .

7 - The SmartLink task now displays in the text field.

8 - Click Save and close the Task Builder dialog.

9 - From the Definition toolbar, select the Event Trigger button.

10 - Click on New and enter Decrement Card Usage as the event trigger name.

11 - In the Trigger source section, select Door from the component type list.

12 - Click on the three-dot to select the component .

Note: You c an also select a group of components or all the components as a trigger source.

13 - In the Trigger destination section, click on the three-dot to select the SmartLink .

14 - Click on the three-dot to select Decrement Card Usage Count as the task.

15 - From the Events tab, select events.

16 - Click on Save and Close .

Building a Task with a Trigger Value Variable

1 - From the Definition toolbar, select the Task Builder button.

2 - Click on New and enter Trigger value as the task name.

3 - Click on the Command button.

4 - From the SmartLink Task Builder window, select Relay from the Component type drop-down list.

5 - Select Toggle relay activation from the Command list .

6 - Select Trigger variable #1 from the Variable list . The task displays at the bottom of the dialog. Click OK .

7 - The SmartLink task now displays in the text field.

8 - Click Save and close the Task Builder dialog.

9 - From the Definition toolbar, select the Event Trigger button.

10 - Click on New and enter Trigger value as the event trigger name.

11 - In the Trigger source section, select Door from the component type list.

12 - Click on the three-dot to select the component .

Note: You can also select a group of components or all the components as a trigger source.

13 - Click on the three-dot to select Always valid as the Trigger schedule .

14 - Check the Use extended filter option.

15 - In the Trigger destination section, click on the three-dot to select the SmartLink .

16 - Click on the three-dot to select Trigger value as the task.

17 - Check the Use task variable option.

18 - From the Events tab, select the Access granted event.

19 - Click on Save .

20 - Click on the Variable tab.

21 - Select Relay for both as the variable type.

22 - Click on the Extended filter tab.

23 - Select Card as the Filter type, then select the component filter and both variables .

24 - Repeat Step 23 for as many cards as required.

25 - Click on Save and Close .

Building a Task with a User Information Variable

1 - From the Definition toolbar, select the Task Builder button.

2 - Click on New and enter Toggle Relay via User Information as the task name.

3 - Click on the Command button.

4 - From the SmartLink Task Builder window, select Relay from the Component type drop-down list.

5 - Select Toggle relay activation from the Command list .

6 - Select User Information 1 from the Variable list . The task displays at the bottom of the dialog. Click OK .

7 - The SmartLink task now displays in the text field.

8 - Click Save and close the Task Builder dialog.

9 - From the Definition toolbar, select the Event Trigger button.

10 - Click on New and enter User Information as the event trigger name.

11 - In the Trigger source section, select Door from the component type list.

Note: You can also select a group of components or all the components as a trigger source.

12 - Click on the three-dot to select the component .

13 - Click on the three-dot to select Always valid as the Trigger schedule .

14 - In the Trigger destination section, click on the three-dot to select the SmartLink .

15 - Click on the three-dot to select Toggle Relay via User Information as the task.

16 - From the Events tab, select the Access granted event.

Note: Make sure the User Information is entered correctly. Check below for an example from the Users toolbar > Card Dialog > General tab. Number 1505 is the RELAYID of the relay that will toggle when the task is performed.

17 - Click on Save and Close.